This manual uses the following headings and markers to separate relevant sections:
»»»»»»»»»»»»»»
Chapter Name __ Sub-Heading __
«««««««««««««««
»» Denotes a Sub-Topic.
•• IMPORTANT NOTE •• is something you must read.
• NOTE • is something you should read.
A small description of the contents of each Chapter follows its name.
»»»»»»»»»»»»»»
INTRODUCTION
«««««««««««««««
•• This section describes what SpaceAlert does. ••
SpaceAlert is a utility to monitor space on disks and RAM. It creates a bar which displays information about them. The program is designed to run in the background.
__ System Requirements __
-System 7.0 or newer.
-70K of free RAM to run.
__ SpaceAlert Features __
-Instantly finds free space on networks WITHOUT mounting volumes first.
-Displays space free, used, capacity and trash in each volume.
-Displays RAM available to open applications, logical and physical RAM.
-Uses relative, subtotal or absolute percentages; or MB & KB values.
-Sorts volumes by any of 7 different attributes.
-Issues different kinds of warnings when space is low on a volume.
-Sets individual or bulk thresholds for volume warnings.
-Excludes volumes from warnings by type or name.
-Abbreviates volume names to display more information at once.
-Can use a double-height window to fit even more information.
-Has extensive Balloon Help support.
SpaceAlert is an application, it is does not alter any System parameters or files or cause malfunctions in other programs. It can also be launched and quit at any time without fear of damaging your work, your System or itself. You do not have to restart your machine to activate it.
»»»»»»»»»»»»»»»
INSTALLATION
«««««««««««««««
•• This section tells you how to install SpaceAlert. ••
To install SpaceAlert, simply copy it onto your hard drive and place it in the Startup Items folder of your System Folder. If you wish you can also place an alias of it in your Apple Menu Items folder. Since this utility is an application, you do not need to restart your computer to use it, just double-click its icon. If you want to stop using it, bring it to the foreground and quit it.
The first time you use SpaceAlert the program will be using the default values for displaying information. To change the settings of the program just bring it to the foreground by clicking in the SpaceAlert bar or selecting its name from the Application menu in the top right of the menubar. At the very least you’ll want to change the settings so that the program automatically goes to the background when it is launched. See the Usage section to find out more about setting the preferences you like.
»»»»»»»»»»»»
INTERFACE
««««««««««««
•• This section describes the SpaceAlert interface: the menus and the bar ••
The most important element of the SpaceAlert interface is the display bar. This is where all the information about RAM and disk usage will be displayed. If you click in the bar you will bring the application to the foreground if it isn’t already there. You can also use the Application menu to do that.
Once in the foreground, you’ll see that there are six menus. They are titled File, Edit, Setup, Font, Size and Style. These menus give you access to the features in the program. Each menu and its relevant menu items follows.
__ File Menu __
-Close Window: used to close a selected window other than the display bar.
-Transfer: used to launch an application without the help of the Finder.
-Quit: Exits SpaceAlert.
__ Edit Menu __
-Works just like it does in any other application.
__ Setup Menu __
-FindServers: finds all network servers with a certain amount of free space.
-Colors Submenu: changes the colors in the SpaceAlert bar.
-Console: displays a window which leads to other settings.
Each icon displays a dialog to edit preferences.
-Slide View: display information to the right or left of the information showing.
-Align Window Submenu: places the SpaceAlert bar at the top or bottom of a screen.
__ Font __
-Lets you select the font for the display bar.
__ Size __
-Lets you select the size of the font for the display bar.
__ Style __
-Lets you select the style of the font for the display bar.
That’s it for the interface, we’ll move on.
»»»»»»»»
USAGE
««««««««
•• This section explains the way to set up and use the features of SpaceAlert. ••
Most of what you need to know is in the Balloon Help of the program.
There are many things which you can customize about the behavior and look of SpaceAlert. We will divide them into two categories: Non-Informative and Informative. Let’s start with the latter…
»» The Informative Category
This category represents the type of information you want to see SpaceAlert display. To gain access to the settings in this category you need to use the Console. Select it from the Setup menu.
The Console has five big icons representing most of the settings for the program. Each of those five icons displays a dialog when clicked. Display and Abbreviation are the information providers. Let’s start with the Display dialog.
• NOTE •
Most dialogs in SpaceAlert have a little Balloon Help icon at the bottom. If you click in that icon you will enable or disable help balloons. Use that feature to find out what an item in a dialog window does. It is wise to use this feature to get acquainted with all the controls in a dialog. You can also use the balloons to find out about items in windows and menus.
__ Display Dialog __
It has four groups of controls and menus. The items on the top control the volume information, the ones in the center left control RAM information, the ones to the right control the size information and the menu at the bottom controls the sort information.
The volume information controls are all checkboxes. To select one of the attributes so that it is displayed in the SpaceAlert bar simply check it. The order in which you enable each checkbox will be the order in which the volume information will be displayed. If you want to display the volume name and then the space used followed by the size of the trash, click on those three in that order and uncheck any other checkboxes in this same group. The easiest way to set the volume information to the order you want is to first uncheck all the boxes and then click the ones you want.
• NOTE •
The trash feature gathers information about trash on a volume whenever you drag anything into or out of the trash. If you have a large amount of things (say 700 files) in the trash of a particular volume it might take a few seconds for SpaceAlert to find the size of the trash for that volume. Don’t worry, it will not spin your disk forever and it will only do this once as long as you don’t drag anything else from that same volume into or out of the trash.
The RAM information controls are also a group of checkboxes. The RAM information is also displayed in the order you check it but it is always displayed after all the volumes in the SpaceAlert bar.
The size information controls are to the right. They are a group of radio buttons and a pop-up menu. The values in the SpaceAlert bar will be displayed using the value type you select. If you are using percentages, the pop-up menu will let you choose what type to use. Read the balloons to find out more about what each type represents.
• NOTE •
The RAM information is never displayed in percentage form.
The Largest Free Block of RAM is always displayed in KB.
Finally, at the bottom of the dialog is the sort pop-up. It lets you select the order in which volumes will be displayed. Remember that RAM information will not be affected by the order in which you sort the volumes.
__ Abbreviation Dialog __
It lets you control what the volume names look like when they are displayed in the SpaceAlert bar. Volume names are abbreviated by passing them through a series of filters that either keep or throw out parts of the name, passing on the valid portion to the next filter. The only items that don’t affect volume names are the Label radio buttons.
Labels are the descriptors used to classify information about volumes and RAM. Only the first volume in the SpaceAlert bar will display labels next to the values which they describe. The RAM information is always labelled and is not affected by the other filters.
Partial labels are only the first letter of the label name for volume information and the first letter of each word for RAM information. For example, “Free” is shortened as “F” and “Physical RAM” is shortened as “PR”.
One checkbox is particularly important. The First Valid checkbox filters out all but the first character that passes through each filter.
• NOTE •
Case is filtered before Letter; if you use both, the Letter filter will get only one valid letter or maybe none at all. It is best to avoid using both if you have the First Valid option on.
The Don’t Abbreviate checkbox bypasses abbreviation altogether thus giving full names and labels. You can also achieve the same effect by setting the right combination in the other controls but this is much quicker.
»» The Non-Informative Category
This category represents the preferences which mostly don’t alter the information that is displayed but rather the way in which it is displayed.
__ Window Dialog __
It lets you select the behavior of the display bar. You can choose to make it movable, re-sizeable or double-height. You can also send SpaceAlert to the background when it is launched by checking the appropriate box. It is recommended that you do this.
To re-size the display bar you click and drag in its bottom right corner.
To move it you click and drag anywhere else on it.
It is a good idea to place the bar wherever you want it to be and then change the settings so that it cannot be accidentally moved.
__ Warning Dialog __
Together with the Exclusion dialog it controls the warning features of the program. They can let you stay fully aware of what your free space situation is.
The Warning dialog sets the type of warnings and the thresholds at which the warnings should be triggered. This dialog has two sections. The one on the top is a list of all the mounted volumes. When you are not using individual warnings, volume names are not displayed in the list, instead there is one entry for all volumes. The bottom radio buttons set the type of warnings.
• NOTE •
If warning is off then no list is displayed.
To set thresholds, you double-click on a name in the list. That will show a small dialog where you can type the amount of free space in Kilobytes (K) at which that particular volume will trigger a warning. You may also use the slider to set the value.
On the left end of the slider there is a marker denoting that the edge of the slider is either the biggest amount of free space available now (when setting the global threshold) or the amount of free space on a particular volume. If you wish, you may set the threshold to a value that is to the left of the slider's limit by typing it in but beware, that will trigger warnings left and right because you're setting the threshold beyond what is currently available.
• NOTE •
This number cannot exceed the capacity of a volume. Make sure you choose an amount carefully so as not to issue useless warnings and also keep in mind that the amount is in Kilobytes, not Megabytes.
To set one warning threshold for all volumes, use the Bulk radio button and double-click on the list. The maximum number you can enter now is the largest capacity available.
You can avoid warnings altogether by selecting the Don’t Warn radio button.
•• IMPORTANT NOTE ••
When you open this dialog, all the thresholds are reset to zero. All thresholds which you do not specifically enter while using this dialog will be set to zero when you exit with the Done button. If you want to keep the thresholds you already have, don’t close the dialog by using the Done button, instead use the Cancel button. On the other hand this is a quick way to reset all volumes so they don’t trigger warnings or to set warnings for only one volume.
There are two types of warnings in SpaceAlert. One passive which only lets you know that some volume is low on space by playing a sound. The other active which displays a dialog window which you have to dismiss in order to continue using the computer.
This active warning tells you which volume is low and how much space it has left.
• NOTE •
Warnings will only be triggered once. To reset a warning without quitting SpaceAlert you must use the warning dialog to set new thresholds. You must also set new thresholds if you change the name of a volume that was in the warning list.
__ Exclusion Dialog __
Together with the Warning dialog it controls the warning features of the program.
It lets you screen out warnings. By setting the appropriate checkbox, volumes with that attribute will not trigger a warning. This is useful if you don’t want to be bothered by floppies, CD-ROMs or network volumes.
You can also set a list of specific volumes that will be excluded. Check the Use List checkbox and place a checkmark before the names of the volumes to exclude. Do this by double-clicking on them or using the Reverse button to toggle their status.
•• IMPORTANT NOTE ••
When you exit this dialog by using the Done button a new exclusion list is created. If you previously checked some volume but it is not currently mounted and thus not displayed in the dialog, you can keep it in the list by using Option-Done to exit the dialog. This merges the old list with the new list.
• NOTE •
Since the exclusion list cannot differentiate between two or more volumes with the same name, excluding one of them will exclude all duplicates. Furthermore, once a volume is warned, any duplicates will not trigger warnings. Keep these limitations in mind when you set up and avoid using duplicate names in your volumes.
One last point. To revert settings to their shipping values quit SpaceAlert and drag the file “SpaceAlert Settings” to the trash. That file is in the Preferences folder of your System folder.
»»»»»»»»»»»»
NETWORKS
««««««««««««
•• This section describes the FindServers feature. ••
You can skip it if you don’t have a network.
The FindServers feature is a unique tool that lets you query network servers to find a certain amount of free space. When you use it, you are asked to supply an amount in Megabytes to look for. Instantly, you get a list of volumes which meet the criteria.
A window will appear with a heading that states the amount of free space in MB you’re looking for. One by one, qualified volumes will be added to the list. Once the search is ended a total for the number of volumes found will be added at the end of the list.
Although the FindServers feature works extremely fast, there is a Halt button provided so you may stop the search at any moment. It is unlikely you’ll ever use it.
When a volume is found the name of its computer is listed first, then the name of the zone in which that computer is found. Under these two is a list of the volumes from that machine that qualify in the search. To easily distinguish between computers, zones and volumes, each category is indented a few spaces from the left.
If you do a search for only 1 MB, which is the minimum amount, you will get a list of most if not all the servers available.
• NOTE •
The maximum number of volume names returned in the list is twenty. If you need a higher limit, contact me to provide you with a modified version of SpaceAlert that will fit more volumes in the list.
FindServers is a tremendous time saver for large companies with many servers and lots of volumes. Using it can help lower network traffic by preventing people from mounting multiple volumes just to look for space. It can also save users a lot of time and frustration while saving Network Administrators a lot of grief.
There is one caveat. Of course, it is a BAD IDEA to save files on a network anywhere they fit. DON’T DO THAT. Instead, use this feature to see which of the volumes where the data SHOULD go are available to take it, then just mount one of them by using the Chooser and put the file where it belongs.
To resume monitoring information with SpaceAlert after a FindServers search, you must dismiss the list by using the Close Window command in the File menu or clicking the window’s close box.
•• IMPORTANT NOTE ••
FindServers requires that the SpaceServer application be running on any servers from which you expect to get information. SpaceServer is a separate shareware program.
»»»»»»»»»»»»»»»»»»»»
UNIX AND SPACEALERT
«««««««««««««««««««««
•• This section tells you how to use SpaceAlert in a Unix setup. ••
•• IMPORTANT NOTE ••
The network features of the program work even if you don’t have Macintoshes as your servers.
Here is some information about how your company could use SpaceAlert & SpaceServer in its Mac network to let clients monitor their disk space and find free space on servers quickly, avoiding the frequent mounting and unmounting of network volumes. You can use both programs if your servers are running System 7 or A/UX or even if you have non-Apple (i.e. Sun or other brand) servers running Unix…
If you have a large Macintosh network (10 to 300+ Macs) with several file servers and many clients chances are the clients waste a lot of time when a server fills up trying to look for a volume with enough space to take the data they have. They have to go to the Chooser and mount volumes without knowing beforehand if they will find space there.
If the problem described above applies to your network, SpaceAlert can help. It allows clients to instantly get a list of the volumes available on the servers that have a certain amount of free space, WITHOUT mounting the volumes first. This saves people a lot of time, especially if you take into account their collective mounting/unmounting of network volumes.
The SpaceAlert and SpaceServer utilities are both very small, stable applications (not INITs or control panels) that are designed to run in the background on Macs that have System 7 or newer. They do not patch any System parameters or files, thus making them compatible with all your existing software.
SpaceServer is a tool for letting SpaceAlert clients find free space on a server without having to mount volumes first. It exchanges information with clients very quickly when it is queried.
The combination provides a very simple and elegant solution to this administrative problem of mounting/unmounting that has distinct advantages, most notably that it works if you don’t have Macintoshes as your servers. Depending on the organization of the volumes and departments in your company, you could do the following for each server/department or all at once.
If you have Apple, IBM-compatible or other Workstations running Unix as your file servers:
You can run SpaceServer in any one of the Mac clients on your network as a way to let people find server volumes with x amount of free space. You have that one client Mac mount all the volumes of a particular server, say, a SparcStation for example, which people want to find information about.
Using SpaceServer as a remote server you ignore local volumes and export the real server's volume names from the client. Then when the server fills up, other clients who want to find free space on the network without mounting volumes just use a menu command in SpaceAlert. They will instantly get a list of all the server volumes with a certain amount of free space in them, without using the Chooser and without wasting any time at all.
The big benefit besides saving time is that you don't even have to worry about the possibility of your servers going down because it's only a client machine running the program.
The FindServers feature is very quick, needing only a minimal amount of information to be exchanged between each SpaceServer and SpaceAlert during a search, so network traffic is not adversely affected. The special client machine in which you mount the Unix volumes does not need to be completely dedicated. As long as you do not tie up the machine doing something else which disrupts background processing a lot, like rendering a 3-D image all day for example, things should be great.
The only thing you would want to do is change the name of the special clients to something which identifies the true name of the server which each represents; you wouldn't want your users to get confused about where a volume is. Something like "SpaceServer_for_ServerName" would do.
If you’re using servers that are running System 7 you can just run SpaceServer directly on them with no need to do the above.
»»»»»»»»»»»»»»
PURCHASING
«««««««««««««
•• This section tells you how to buy/register SpaceAlert. ••
SpaceAlert is shareware, meaning try-before-you-buy software. You can use it for a period of one week at no charge to determine whether or not it suits your needs. If after that time you decide it does, to legally keep it you must pay the asking price according to which of the following three categories you qualify in:
--Corporate Use--
If you are a company buying for your LAN, you pay $15 per group of three machines or less on your network (i.e. 8 machines = $15 * 3 groups= $45), up to a maximum of $300 which buys you unlimited use within your site.
--Office Use--
If you are buying for office use and not for the whole company, pay $15 per group of three machines or less. Note that if you make SpaceAlert available to others on the network you don't qualify for this category, you qualify for the one above.
--Personal Use--
If you are not buying for any of the categories above and you'd like SpaceAlert for you and your family's personal use, you need only pay $15.
•• NOTE ••
Registered FreeSpace! users can upgrade to SpaceAlert for free. Please e-mail or phone me to place your name in my SpaceAlert customer database.
•• IMPORTANT NOTE ••
Make your check out to Hugo Diaz and mail it to the address listed in the next section.
•• IMPORTANT NOTE ••
You need SpaceServer to use the FindServers feature of SpaceAlert. The use of SpaceServer is NOT included in the above price. You must buy/register it separately. The asking price for SpaceServer follows:
--Corporate Use--
If you are a company buying for your LAN, you pay $100 if your network has less than 100 machines, $200 if it has between 101 and 150 machines or $300 for a larger network. Any of these sums entitles you to use as many copies of SpaceServer as you need within your site.
»»»»»»»»»»»»»»
GETTING HELP
««««««««««««««
•• This section tells you how to contact the author for help and feedback. ••
If you should encounter a problem with this program or have any questions, comments, praise or suggestions you can contact Hugo Diaz, the author, at the (617) 924-8768 phone number in the United States. Let him know if there is a feature you would like to see in SpaceAlert.
You can also e-mail him at America Online screen name SKIDE or via internet as skide@aol.com.
You may also mail a letter (and your payment) to the following address:
H Diaz
32 Whites Ave #6608
Watertown, MA 02172-4351
USA
»»»»»»»»»»»»»»»»»»
COPYRIGHT NOTICE
««««««««««««««««««
•• This section describes the Copyright information. ••
SpaceAlert is protected by Copyright Laws and International Treaties signed by the USA and virtually every country in the world. Unauthorized use, duplication or distribution is illegal.
__ LEGAL MATTERS __
This program may be freely distributed provided that:
-No special charges beyond normal connect charges are made.
-It is not included in a bundle with any other software.
-It is not sold.
-It is not modified in any way.
-It remains together with its documentation.
If you’d like to distribute this software in a CD-ROM, diskette or other bundle, for profit or not, you must get my approval first.
